home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / COMMADIO / FIDOBBS2.LZH / SHUF132A.ARC / SHUFFLE.DOC < prev   
Text File  |  1985-10-03  |  10KB  |  288 lines
  1.  
  2.  
  3.  
  4.  
  5. SHUFFLE                                                     version 1.32                         (c) 1985 by Robert Lederman
  6.  
  7.                                                           3 October 1985
  8.  
  9. Description
  10. -----------
  11.  
  12.      SHUFFLE is a time-saving utility which allows Fido sysops easily to
  13. move   files   and  corresponding  FILES.BBS  entries   among   download
  14. directories.  It  also permits rudimentary editing of file descriptions.
  15. Written  in  Borland  International's  Turbo  Pascal  3.01,  SHUFFLE  is
  16. designed to be used locally as  well as remotely, by taking advantage of
  17. ANSI.SYS control codes.
  18.  
  19.  
  20. Requirements
  21. ------------
  22.  
  23.      SHUFFLE requires an IBM PC, XT,  AT,  or  BIOS-compatible  computer
  24. running FIDO, Tom Jennings' remote  bulletin  board system.  A hard disk
  25. is recommended.  When run from a local console, SHUFFLE requires the use
  26. of ANSI.SYS or equivalent device driver.   When  run  remotely,  SHUFFLE
  27. requires  that  the  remote  communications package use  ANSI.SYS  (like
  28. Minitel or Qmodem) or VT100 emulation.
  29.  
  30.      SHUFFLE should be stored on the same subdirectory that contains the
  31. Fido system files (SYSTEMn.BBS).  In any  case,  the  current  directory
  32. MUST contain those Fido files whenever running SHUFFLE.
  33.  
  34.  
  35. Restrictions
  36. ------------
  37.  
  38.      SHUFFLE will work properly only if your  Fido system contains 50 or
  39. fewer file areas.  Undesirable -- not  destructive  --  results  may  be
  40. achieved beyond that limit.
  41.  
  42.      Due to  memory  restrictions,  SHUFFLE  should  NOT  be  used  with
  43. FILES.BBS listings that contain more than 350 lines.   Lines beyond that
  44. limit  will  be  be  lost.  You will be warned if you ever  exceed  this
  45. limit.
  46.  
  47.      FILES.BBS text listings MUST terminate with a cr/lf  before the EOF
  48. marker.  Just hit carriage return when editing the last line of the file
  49. before saving it.  Fido ordinarily terminates FILES.BBS entries in  this
  50. fashion, anyway.
  51.  
  52.      DON'T WORRY!  SHUFFLE always  backs  up  the  active  FILES.BBS  as
  53. FILES.BAK before changing anything.
  54.  
  55.  
  56. Operation
  57. ---------
  58.  
  59.  
  60.  
  61.  
  62.  
  63. SHUFFLE v1.32                 -1-             Call Met-Chem 203/281-7287
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.      Making sure that the current directory is the  Fido directory, type
  77. SHUFFLE from  DOS  prompt, either locally or after using the '0' command
  78. to exit Fido remotely.  Try using SHUFFLE from a remote terminal -- it's
  79. really neat!
  80.  
  81.      At this point, a simple  description  will be displayed and SHUFFLE
  82. will display a menu of all  file areas, each with the corresponding Fido
  83. area number.
  84.  
  85.      You will now  be  asked  to  choose an active file subdirectory for
  86. viewing, manipulating, and SHUFFLE-ing files.  SHUFFLE will pause a  few
  87. seconds to load the files.bbs and directory  information in the area you
  88. choose Afterwards you will see the following menu:
  89.  
  90. new area#,Edit,Insert,Jump,Kill,Move,Next,Orphan,Previous,Rename,Scan,Quit:
  91.  
  92. and the first entry of your  FILES.BBS.  If the line contains a comment,
  93. it will be marked COMMENT.   A line is considered a comment if the first
  94. character is  a '-', '=', or a ' ' (space), or if the length of the line
  95. is  less  than  two  characters.   Otherwise,  the file name, size,  and
  96. creation date  is  displayed.   If the active directory does not contain
  97. the file listed in the FILES.BBS, then it is marked MISSING.   The  file
  98. description is displayed on the next line.
  99.  
  100.  
  101. Commands
  102. --------
  103.  
  104.      Hitting <Return> will display the next entry in  the files.bbs that
  105. has not  been  deleted or redirected.  SHUFFLE will "wrap" from the last
  106. entry back to the beginning of the FILES.BBS.
  107.  
  108.      The  (N)ext  and  (P)revious  commands  act  as direction  toggles.
  109. Hitting 'P' for example  will  display  the  previous  active  files.bbs
  110. entry, and all subsequent <return>'s will move backwards.   Hitting  'N'
  111. will display  the  next  active entry, and all subsequent <return>s will
  112. move forward.
  113.  
  114.      Entering a NUMBER corresponding to a file area will REDIRECT a file
  115. from the current subdirectory to the selected  file area, and append the
  116. files.bbs entry to the files.bbs of the  target area.  It's that simple.
  117. [Note that versions  1.31  and  higher  can  redirect  files across disk
  118. drives and hard disk partitions.  It is your responsibility, however, to
  119. make sure there is enough space on the target drive for the copy.]
  120.  
  121.      The (J)ump  command  directs SHUFFLE to Jump to a specified line in
  122. the FILES.BBS.  You will be prompted for a line number.  If that line no
  123. longer exists  (if  it has been deleted or redirected), then you SHUFFLE
  124. will display the next active line.
  125.  
  126.  
  127.  
  128.  
  129. SHUFFLE v1.32                 -2-             Call Met-Chem 203/281-7287
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.      The (K)ill command permits you  to  delete the current entry and/or
  143. the corresponding file.  You are prompted for each deletion.  Be careful
  144. with this.
  145.  
  146.      The (I)nsert command inserts a  blank  line before the current one,
  147. ready for (E)diting.
  148.  
  149.      The  (E)dit  command  permits  you  to  edit  the   file  name  and
  150. description fields.  To edit the FILES.BBS file description field,  type
  151. your new description and then  hit  <Return>.  SHUFFLE marks the maximum
  152. length  of your entry to  avoid  annoying  "wrap"  using  the  Fido  'F'
  153. command.To edit the FILES.BBS filename field, just type the new filename
  154. you want listed and hit <ESC>.  Notice the wide flexibility this command
  155. permits.  You can  convert  a  filename  entry into a comment by hitting
  156. <ESC>  without  any characters.  After you enter a new  field,  you  may
  157. (S)ave or (D)iscard it.
  158.  
  159.      The (R)ename command  renames  the  current  file  to  the name you
  160. specify, and updates the current FILES.BBS accordingly.  Notice that the
  161. related  (E)dit  filename function does NOT rename any files,  only  the
  162. description in the FILES.BBS.
  163.  
  164.      The (S) command scans for a keyword (up to six characters) that you
  165. enter.  It searches  both  file  names  and  file  descriptions.  If the
  166. keyword  is  found,  you  may  (C)ontinue  to  search   for   additional
  167. occurances, enter  a  (N)ew keyword, or (S)top at the current entry.  If
  168. no matches are found, you can enter a (N)ew keyword or (S)top and return
  169. to  the  original  entry.   Note  that  wildcard  characters   are   NOT
  170. supported.
  171.  
  172.      The (O)rphan command, inspired  by  Bill  Becker  of  Fido  16/209,
  173. searches the  current  directory  for files not listed in the FILES.BBS.
  174. New file entries for the orphans are appended to the end  of  FILES.BBS,
  175. ready for (E)diting or (K)illing.  Note that FILES.BBS,  FILES.BAK,  and
  176. DIR.BBS are excluded from the orphan search.
  177.  
  178.      The (M)ove  command,  modelled  after DOS Edlin, permits a range of
  179. lines to be moved  elsewhere  in  the  current  FILES.BBS.   You will be
  180. prompted for the first line to be  moved (hitting <return> specifies the
  181. current  line),  the last line to be moved (hitting  <return>  specifies
  182. move the first line only), and where you  want  the  range  to  be moved
  183. (hitting 0 aborts the move).
  184.  
  185.      Choosing the  (Q)  command saves all changes in a new FILES.BBS for
  186. the current area.  The  old  one  is renamed to FILES.BAK.  You may then
  187. choose a new file area for shuffling or (Q)uit and exit shuffle.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. SHUFFLE v1.32                 -3-             Call Met-Chem 203/281-7287
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208. Shareware
  209. ---------
  210.  
  211.      If you  like  and use SHUFFLE, especially if your FIDO is sponsored
  212. by  a  commercial  establishment,  your  contribution  would be  greatly
  213. appreciated.  Please make all checks payable to:
  214.  
  215.      Robert J. Lederman
  216.      7001 Yale Station
  217.      New Haven, CT 06520
  218.  
  219. Nevertheless, any comments or suggestions are solicited.  You  can  post
  220. them, and  receive  the latest version of SHUFFLE on Met-Chem Fido 16/42
  221. in New Haven, 203/281-7287.
  222.  
  223.  
  224. Recent Release History
  225. ----------------------
  226.  
  227.      Version 1.32 fixes a bug in version 1.31 that causes ALL  files  to
  228. be copied rather than redirected --  SHUFFLE was a little slow there for
  229. a while.
  230.  
  231.      Version 1.31 allows files to be "redirected"  across  disk  drives.
  232. Thanks to  Bela  Lubkin for his file copy routine.  "_ghost_" file areas
  233. are no longer displayed at all.
  234.  
  235.      Version 1.3 has  a  completely rewritten non-Turbo APPEND procedure
  236. that solves previous bugs  in  redirecting  FILES.BBS entries.  Comments
  237. may now be redirected.  The (E)dit command can now  be  used  to  change
  238. file names in FILES.BBS without actually renaming the  file.  The (M)ove
  239. command has been  added  to  allow  EDLIN-style moving of text.  The new
  240. (I)nsert  command  inserts  blank  lines that can  be  changed  to  File
  241. descriptions or comments using the improved  (E)dit  command.   The  new
  242. (O)rphan command searches the active subdirectory for files  not  listed
  243. in FILES.BBS  and  appends them to the end for further (E)diting.  [Last
  244. minute note: the APPEND bug is a problem specific to the  Columbia  MPC,
  245. not IBM PCs or  with  Turbo  Pascal  as expected -- the problem has been
  246. worked around.]
  247.  
  248.      Versions 1.22b through  1.22f  attempted  to  fix  a  sporadic  and
  249. unexplained failure to redirect FILES.BBS entries.  It  derived  from  a
  250. bug in Turbo Pascal's APPEND procedure.
  251.  
  252.      Version 1.22 adds the (R)ename feature.
  253.  
  254.      Version 1.21 Was incorrectly released, and did not correctly append
  255. redirected FILES.BBS entries to the target  file  area  FILES.BBS.   The
  256. wrong program was incorporated into the library.  Sorry.
  257.  
  258.  
  259.  
  260.  
  261. SHUFFLE v1.32                 -4-             Call Met-Chem 203/281-7287
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.      Version  1.20  allows  quick-response:  no   unnecessary   carriage
  275. returns.
  276.  
  277.  
  278. Upcoming Features
  279. -----------------
  280.  
  281.      Expect  future  versions of SHUFFLE to have some of  the  following
  282. features:
  283.  
  284.   -  Full-screen display  of  multiple  FILES.BBS  entries,  using VT100
  285.      commands for remote operation.
  286.  
  287.   -  Ability  to  redirect FILES.BBS entries to  predetermined  line  on
  288.      target FILES.BBS  (for  redirect